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This software is copyright Criterion Software Limited 2000. All Rights 
Reserved. 


This software is furnished under a license agreement or a 
non-disclosure agreement. The software may be used or copied only in 
accordance with the terms of the agreement. It is against the law to 
copy the software on any medium except as specifically allowed in the 
license or non-disclosure agreement. 


RenderWare is a registered trademark of Canon Inc. 
Other trademarks acknowledged. 


Welcome to RenderWare3 (PS2 Gold) 


This release of the RenderWare 3 SDK is for the Playstation 2 platform. 


This is an update of the original PS2 Gold SDK to support the 1.3 
toolchain from Sony. 


This release was compiled using release 1.3.2 of the Sony EB Tool 
Chain. All the pre-compiled binaries will require an 1.3.2 
environment, implying flash 1228. It should be possible to use the 
libraries with later releases of the Tool Chain, though this has not 
been tested. 


The sample code provided with the demos contains generic functionality 
for using a millisecond timer. This functionality assumes a 100MHz bus 
clock. : 


The RenderWare SDK for PS2 consists of 2 major components. One is the 
run time & development environment which is hosted on a Linux 
development platform. The other is the PC Tools which run on a PC 
platform. The PC Tools can be installed from the PCTOOLS directory on 
the CD. 


To install the RenderWare3 SDK on PS2, simply copy the CD directory 
structure onto your development platform. It is recommended that you 
‘rename your existing (beta) RenderWare3 SDK tree to rw3.beta, or 
similar, and to not copy the release SDK over the top of the beta SDK. 


The following directories exist in the PS2 portion of the SDK 


APP/DEMO 


A number of RenderWare demo programs in executable form plus the 
source code for these demos. The following demos are provided: 


bones - demonstrates the use of the animation and bones plugins 


cars - a very simply racing game demonstrating performance and 
LOD 

dice - simple demo showing the use of RenderWare's collision 
functionality 


dungeon - first person shooter demo showing use of PVS plugin 
kaleido - shows complex frame hierarchy manipulation 


lodview - simple LOD model viewer 
paint2d - Shows use of RenderWare 2D plugin for TV style 2D graphics 


soccer - Sports game demo showing 25 animated characters at 
high frame rate 
view - simple world and object viewer 
viewpp - simple example showing RenderWare used in a C++ 
application 
APP/SKEL 


A simple event model abstraction layer. All of the RenderwWare 
demonstration programs use this layer to isolate the application from 
the underlying OS and hardware. 


DOC 

The RenderWare API Reference Manual as a PDF file. 

A Getting Started with RenderWare manual 

A tech note on getting good RenderWare performance on PS2 
A tech note on evaluating RenderWare 

RenderWare FAQS 

RenderWare do's and don'ts 


INCLUDE 

This directory contains the main RenderWare header files. This 
directory should be on the include path when building a RenderWare 
application. Note: there is a separate set of include files for each 
RenderWare configuration. For a Ps2 application use include/sky. 


LIB 

This directory contains the RenderWare library files. This directory 
should be on the link path when building a RenderWare application. 
Note: there is a separate set of include files for each 

RenderWare configuration. For a PS2 application use lib/sky. Debug 
versions of all of the libraries are also provided in lib/sky/debug 


The following libraries are provided with this SDK: 


librwcore.a - Core RenderWare library. 

librpanim.a - RenderWare animation plugin. 

librpbon.a - Bones skinned animation plugin. 

librplogo.a - Overlay RenderWare logo. 

librpmeminf.a - Memory information plugin. 

librpmemlk.a - Memory leak tracing plugin. 

librpmorph.a - Morph target animation plugin. 

librppvs.a - Adds PVS functionality to RenderWare worlds. 
librprandom.a - Random number generator. 

librpspline.a - Spline path support. 

librpstereo.a - Stereo camera support 

librpworld.a - World management plugin. 

librtcharse.a - Toolkit which provides limited font support. 
librtimport.a - Geometry import utility functions. 
librtray.a - Line of sight plugin. 

librtslerp.a - Slerp toolkit for matrix animation. 
librtworld.a - Toolkit providing additional world utilities. 


The following directories exist in the PC portion of the SDK 


LIB 


A set of NULL RenderWare libraries (as above) which are needed to 
rebuild the modeller components. 


INCLUDE 


A set of NULL RenderWare headers for the above libraries which are 
needed to rebuild the modeller components. 


MODELLER 


This directory contains export utilities for 3D modelling packages 


modeller/3dsmax - A 3DS Max Plugin that allows the export of 
RenderWare binary data. 


modeller/maya - A Maya Plugin that allows the export of 
RenderWare binary data. 


DOC 


A copy of the documentation for reference 


TOOL 


A simple RenderWare stream viewer utility program 


The sample source provided with this SDK may be constructed from the 
command line. The command line makefiles provided are for the GNU Make 
program and will construct the SKY release version of the programs by 
default. Other configurations can be built by specifying makefile 
options in the options.mak file in the demo directory. The supported 
options for this file are as follows: 


RWDEBUG = 1 | 0 (Use RenderWare debug libraries.) 

CDEBUG = 1 | 0 (Build with C debug information.) 

RWSDK = <path to rwsdk> 

RWLOGO = 1 | 0 (enable/disable the RenderWare logo) 

RWMOUSE = 1 | 0 (enable/disable emulation of a mouse on PS2) 


Developers who wish to develop their own plugins using the object 
extension mechanism should use their allocated used ID as the root. 
This ID can be used to generate 256 separate plugins. If you need more 
ID's than this then please contact Criterion for further user ID's. 


For the most up to date documentation and information on RenderWare, 
please visit the developer web site at 


http: //developer.renderware.com. 


This location is also the primary support mechanism for Bronze level 
SDK licensees. Silver and Gold licensees have a nominated point of 
contact within Criterion. The engineer reponsible will contact you 
shortly to introduce themselves. If any Bronze level members wish to 
upgrade their support to a higher level then further information can 
be found at 


http: //www.renderware.com 


To get started using RenderWare, please read the getstart.pdf file in 
the documentation directory. 


In addition, please read the FAQs - particularly FAQ no 21 on getting 
the best performance out of RenderWare on PS2. 


We have introduced a number of minor changes to the functionality with 
this interim release. These are detailed below. 


- Support added for tristrip serialisation 

- RpGeometryGetVertexColors has been removed, together with the 
flags rpGEOMETRYCOLORED (a member of the RpGeometryFlag bit-field 
type) and rpWORLDCOLORED (a member of the RpWorldFlag bit-field 


type). 


The areas of the API which are concerned with the construction and use 
of Pipelines is currently under review. A new Pipeline model is 
currently being implemented which is more suited for the PS2 
architecture. As a consequence, all functionality related to pipeline 
overloading is not supported in this release. 


The binary file format has also changed for this release. Files 
created with the previous PC beta SDK tools will need to be 
re-exported with this SDK. 


We are aware of a small number of defects with this release of 
RenderWare. We aim to correct these defects in a future release. 


RenderWare3 Defect List: 


d-364 Tristrips in 3d Immediate mode are dispatched as single 
triangles 


a-377 Can't render into textures 


a-378 No support for Pipeline 2. Pipeline 1 is hard coded into the 
SDK and can not currently be overloaded. This will be 
resolved when Pipeline 2 comes on line. 


d-381 DMA manager isn't exposed 


d-389 Alpha polys not procrastinated. 
YwRENDERSTATEALPHAPRIMITIVEBUFFER currently returns success, 
but there isn't any code so no buffering actually happens. 


d-463 Partial reinstancing of multiple atomics fails 
...locking a geometry without forcing a mesh rebuild (not 
rpGEOMETRYLOCKPOLYGONS), and then instancing several atomics 
which reference that geometry will result in only the first 
atomic being partially reinstanced. Subsequent atomics will 
not realise an update has occured. 


d-556 Logo Plugin and Camera subrasters 
The logo plugin draws a logo for all cameras rendered 
including those whose raster is a subraster. It's 
questionable if it should draw a logo on all the cameras or 
just the main one and it also pays no attention to the 
subraster offsets and so gets the logo position wrong. 


d-576 BMP/RAS image loaders should be tools. 
Rather than being in the core library, they should be 
separate libs to be attached as desired (like the png reader 
is). 


d-632 Leaked Sectors in PVS 
The PVS is showing leaked sectors when in use. Sectors that 
should not be visible are still marked as visible. 


The cause is most likely due to the corner points sampling. To 
resolve problems due to 'unbalanced' distribution of the 
sampling points, the corners of a sector are checked for 
visibility. If the corner is visible from the any of the 
sample points, then the corner is also sampled. It is possible 
that some ‘corners' are incorrectly marked. 


d-642 If the Soccer demo is built with RWDEBUG=1, it sometimes 
fails to run, tight looping in malloc. This looks like it may 
be a bug in Sony's libs. 


RenderWare is a registered trademark of Canon Inc. 
Microsoft, MS, MS-DOS and Windows are registered trademarks of 
Microsoft Corporation. 
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